home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / isam120.zip / README.DOC < prev    next >
Text File  |  1994-07-27  |  4KB  |  97 lines
  1.  
  2. Welcome to ISAM Manager, The B+Tree/ISAM system for C++. This is
  3. the Test-Drive Shareware version of the product, and you must
  4. register if you are still using ISAM Manager after 30 days. Please
  5. see the REGISTER.DOC file for more information.
  6.  
  7. While we can't offer full support to unregistered users, we would
  8. like to hear from you if you have installation problems - we
  9. should be able to help you out. So if you get stuck, give us a
  10. call on 01442 891331 (non-UK call +44 1442 891331) or drop us an
  11. email message at one of our many email addresses.
  12.  
  13. A multi-user version is available, but you'll have to register to
  14. get it. However, we have provided a sample program compiled using
  15. the multi-user version so you can see it in action. Check out
  16. AFMU.EXE in the KEYSRCH directory.
  17.  
  18. IF YOU HAVE ANY DATA FILES CREATED USING PREVIOUS VERSIONS OF ISAM
  19. MANAGER, YOU MUST DELETE THEIR INDEX FILES BEFORE USING THIS NEW VERSION.
  20.  
  21.                              INSTALLATION
  22.  
  23.  
  24. Introduction
  25.  
  26. To Install ISAM Manager, simply insert disk 1 into drive A (or
  27. whatever floppy drive letter you are using), and type the following:
  28.  
  29. A:INSTALL
  30.  
  31. INSTALL will ask you for a drive and directory name to install ISAM
  32. Manager into, which will default to "C:\ISAMMGR". The following
  33. subdirectories off C:\ISAMMGR will also be created:
  34.  
  35. INCLUDE         -       Include files
  36. TUT1            -       Tutorial 1 files
  37. TUT2            -       Tutorial 2 files
  38. TUT3            -       Tutorial 3 files
  39. SOURCE          -       ISAM Manager source code
  40. FSCREEN         -       FScreen Library source code
  41. KEYSRCH         -       KEYSRCH & ADDFILE Example program files
  42.  
  43. You should now add "C:\ISAMMGR" to your DOS PATH statement, as this
  44. directory will contain some important executable files, and
  45. "C:\ISAMMGR\INCLUDE" should be added to your compiler's include file
  46. search path.
  47.  
  48. ISAM Manager is no longer shipped with precompiled libraries, due to
  49. the vast number of C++ compilers, and versions that abound. The
  50. precompiled libraries in previous versions accounted for the majority
  51. of bug reports due to different compiler option settings, different
  52. versions etc.
  53.  
  54. THIS EVALUATION VERSION CONTAINS MANGLED SOURCE CODE, WITH ALL
  55. COMMENTS REMOVED. FULL, UNMANGLED SOURCE CODE IS PROVIDED WHEN
  56. YOU REGISTER. THE MANGLING DOES NOT AFFECT THE FUNCTIONALITY OF
  57. THE CODE, ONLY ITS READABILITY.
  58.  
  59. Instructions for building your own libraries follow in the next
  60. section, but you can use ISAM Manager quite easily without the need to
  61. build any libraries. Simply include all the files from the FSCREEN
  62. directory (if you wish to use the FScreen library for DOS), and all
  63. the files in the SOURCE directory with two exceptions. There are two
  64. files which have different versions for the single user version and
  65. the multi-user version. If you wish to have a single user program, you
  66. should include the files "sidxmgr.cpp" and "sdiskmgr.cpp". For a
  67. multi-user program, include "midxmgr.cpp" and "mdiskmgr.cpp" instead.
  68.  
  69. If you are running under a DOS or Windows environment, you must use
  70. either the Compact or Large memory models (Large is preferable).
  71.  
  72.  
  73. Building Libraries
  74.  
  75. There are many reasons why you may want to build libraries
  76. rather than just including the source files in your project. It
  77. simplifies your projects, and if you have multiple projects on
  78. different platforms (or memory models), you will need to make a
  79. library to avoid having the object files clash with each other.
  80. The process is fairly straightforward, particularly for those
  81. compilers that allow you to create .lib files from within the
  82. integrated environment.
  83.  
  84. To create a DOS single-user library, simply compile all the files in
  85. the ISAM Manager SOURCE directory, except for "midxmgr.cpp" and
  86. "mdiskmgr.cpp", and all the files in the ISAM Manager FSCREEN
  87. directory, and make a library from them. To create a Windows
  88. single-user library, compile the same files, except for the FSCREEN
  89. directory.
  90.  
  91. For multi-user libraries, you should include "midxmgr.cpp" and
  92. "mdiskmgr.cpp" and exclude "sidxmgr.cpp" and "sdiskmgr.cpp". The
  93. multi-user files are not provided in this evaluation version. You must
  94. register to obtain the multi-user version.
  95.  
  96.  
  97.